# 壁球小游戏中使用到的函数与类的解释说明

# pygame.init()函数
"""
作用：
    初始化pygame中各种各样的东西
"""

# ball = pygame.image.load("ball.gif")函数
"""
作用：
    加载图片，并且实例化了一个Surface对象
    pygame中使用内部定义的Surface对象表示所有载入的图像
传入参数：
    所加载图片的路径
    注意：你所需要加载的图片必须是要和你所执行的.py文件在同一个文件夹里面
    如果不在，你就得在传入参数时，写上绝对路径

"""

# ball.get_rect()函数
"""
作用：
    返回一个覆盖原图的矩形Rect对象，目的就是为了能更好的去控制你所加载的Surface对象
传入参数：
    无
返回值：
    Rect对象
"""

# Rect对象的重要属性
"""
top = y       上
bottom = w    下
left = x      左
right = u     右
width = u-x   宽
height = w-y  高
"""

# ballrect = ballrect.move(speed[0], speed[1])方法
"""
作用：
    Rect对象的move()方法可以用于移动对象
参数：
    第一个参数是x方向的偏移量
    第二个参数是y方向的偏移量
返回值：
    返回一个移动过后的新Rect对象，所以你要重新赋值给原来的Rect对象才能产生移动的效果
"""

# screen.fill(BLACK)函数
"""
作用：
    fill()函数是screen模块里的一个方法。
    他的作用是填充整个窗口的颜色
参数：
    传入一个RGB三原色的元组
返回值：
    无返回值
"""

# screen.blit(src, dest)函数
"""
作用：
    src = source; 源文件
    dest = destination; 目标文件
    将一个图像绘制在另一个图像上，即将src绘制到dest位置上。
    通过Rect对象引导对壁球的绘制
"""

# fclock = pygame.time.Clock()函数
"""
作用：
    创建一个Clock对象，用于操作时间

"""

# fclock.tick(fps)函数
"""
作用：
    clock.tick(framerate)函数
    是Clock对象的一个方法，
    用于控制帧速度，即窗口刷新速度
    例如：fclock.tick(100)
    表示每秒100次帧刷新
"""

# pygame.QUIT 是一个pygame事件的全局变量
"""
作用：就是标识程序是否退出
"""

# pygame.KEYDOWN 是一个pygame事件的全局变量
"""
作用：是标识有没有按下键盘这样一个事件的发生
"""

# pygame.K_LEFT
# pygame.K_RIGHT
# pygame.K_UP
# pygame.K_DOWN
"""
作用：是标识上下左右四个按键是否被按下这样一个事件的发生
"""

# pygame.VIDEORESIZE
"""
这是一种窗口大小更改的事件（说人话就是电脑感知到了你放大或者缩小了窗口）
事件发生后，返回event.size元组，包括新窗口的宽度和高度
.size[0]宽度，也可以用event.w
.size[1]高度，也可以用event.h
返回参数仅在事件发生时有用
"""
